Combodo 在 iTop 3.0 版本之後重新改寫了外觀和可用性，包括佈局、顏色、圖標以及功能選單的全面改變。為重要訊息留出更多空間，並突顯您關注的重點，使工作更加有效率。但很可惜的就是一直沒有 iTop 3.X LTS 的版本發行。

使用 LTS(Long Term Support)版本的好處如下

• 高穩定性：通常經過充分測試，確保在企業環境中運行時的穩定性，減少了意外錯誤和中斷的風險。
• 長期支援：提供較長的支援週期，通常包含幾年的安全更新和錯誤修復，讓企業有充足的時間計劃升級。
• 安全性更好：在支援期間內持續獲得安全更新，有效保護系統免受已知漏洞的威脅。
• 減少維護成本：LTS 版本穩定且支援時間長，企業不需要頻繁升級或調整系統，有助於降低維護和運營成本。
• 更好的相容性：LTS 版本通常與其他軟體和模組有更好的相容性，因為這些軟體通常會優先支援穩定的 LTS 版本。

距離上一次推出的 iTop 2.7 LTS 版已經五年了，很開心的 Combodo 終於在 September 2024 釋出了 iTop 3.2 LTS。

新版本帶來了哪些功能，可以參考下列連結。
https://www.itophub.io/wiki/page?id=3_2_0%3Arelease%3Achange_log

目前安裝的 iTop 3.1 版本到 2025 年 Q1 就要 EOS 了

目前已經有 66% 的用戶使用 3.X.X，而有 25% 左右的用戶停留在 2.7.X，強烈建議這些用戶趕快升級到更安全的 3.2.0 版本。

透過 sourceforge.net 下載最新的主程式

注意事項
首先，建議將您的 iTop 與 iTop Hub 進行連結，點選 My dashboard 可以看到您目前種共有多少個 Instances 註冊在上面。

接下來點選想要升級的 Instance，升級需要注意的就是新版的 iTop 與您之前安裝過的 Extensions 是否相容。

您可以在這邊確認目前安裝過的 Extensions 升級上去是否會失效，尤其是那些您已付費的 Extensions。評估升級的效益是否符合成本，否則可能又要花大把銀子把失效的 Extension 升級上去。

檢查目前的環境是否有問題，若有警告 iTop Hub 會在這邊提示建議。

iTop 相容性列表
建議使用 PHP 8.1 與 MariaDB 10.6 這兩個版本，將來升級到 3.2 才不會遇到相容的問題。

如果檢查過後確認都沒問題就可以放心進行升級了

Upgrade Automatically
點選 System 頁面的 Application Upgrade

Select a file 選擇 iTop-3.2.0–2–14758.zip，點選 Verify Upgrade File。

Automatically 的升級方式，僅限於小版次之間的升級，例如將 3.1.0 升級到 3.1.1 版次。

像是 3.1.X 升級到 3.2.X 版本就必須透過 Manually 的方式進行升級

Upgrade Manually
在將您的 iTop 升級到新版本之前，請先閱讀升級路徑上的所有遷移說明。
https://www.itophub.io/wiki/page?id=3_2_0%3Ainstall%3Amigration_notes

現在強烈建議使用 PHP Extension APCu，否則效能可能會略有下降。

sudo apt-get install php8.1-apcu
sudo a2enmod proxy_fcgi setenvif
sudo a2enconf php8.1-fpm
sudo systemctl reload apache2

資料庫更新操作
Attachment : Make contact_id an AttributeExternalKey instead of AttributeExternalField

sudo mysqld
MariaDB [(none)]> show databases;
+--------------------+
| Database           |
+--------------------+
| iTop               |
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+
5 rows in set (0.001 sec)

MariaDB [(none)]> use iTop;
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Database changed
MariaDB [iTop]>
MariaDB [iTop]> ALTER TABLE `attachment` ADD `contact_id` INT(11) DEFAULT 0;
MariaDB [iTop]> ALTER TABLE `attachment` ADD INDEX `contact_id` (`contact_id`);
MariaDB [iTop]> quit

確保您的所有 Trigger On Mention 都定義了過濾器，否則升級到 iTop 3.2.0–2 將會失敗。

備份您當前的 iTop 目錄，可以排除 /data/backups。

cd /var/www/html/
sudo mkdir itop_backup
sudo cp -R itop/ itop_backup/

將下載的套件解壓縮到您的 iTop 目錄中，這將建立一個 /web 子目錄。

wget https://jaist.dl.sourceforge.net/project/itop/itop/3.2.0-2/iTop-3.2.0-2-14758.zip -O /tmp/itop.zip
sudo unzip /tmp/itop.zip "web/*" -d /var/www/html/itop

如果您使用了 /webservices/cron.params，請複製到 /web/webservices。

刪除先前版本的核心檔案

cd /var/www/html/itop
sudo rm -rf addons datamodels images lib manifest.xml portal application core dictionaries env-test index.php navigator setup webservices approot.inc.php css js pages synchro documentation bootstrap.inc.php web.config node_modules sources resources templates data/cache-production/*

您的 iTop 目錄現在應該包含

• 以下子目錄：conf、data、env-product、log、extensions、web
• iTop 目錄層級沒有文件

$ ll /var/www/html/itop
total 36
drwxrwxr-x   9 root     www-data 4096 Oct 15 14:13 ./
drwxr-xr-x   4 root     root     4096 Oct 15 12:00 ../
drwxr-xr-x   3 www-data www-data 4096 Oct  7 11:08 conf/
drwxrwxr-x+ 14 root     root     4096 Oct 15 11:44 data/
drwxr-xr-x  68 www-data www-data 4096 Oct  7 11:08 env-production/
drwxr-xr-x   2 www-data www-data 4096 Oct  7 11:08 env-production-build/
drwxr-xr-x   6 www-data www-data 4096 Aug  6 14:27 extensions/
drwxrwxr-x+  3 root     root     4096 Oct  7 11:08 log/
drwxr-xr-x  24 root     root     4096 Oct 15 13:50 web/

透過啟動此命令複製新版本的核心文件

sudo cp -r ./web/* .

網頁伺服器使用者必須具有存取權限

sudo setfacl -dR -m u:"www-data":rwX /var/www/html/itop/data /var/www/html/itop/log
sudo setfacl -R -m u:"www-data":rwX /var/www/html/itop/data /var/www/html/itop/log
sudo chown www-data: /var/www/html/itop/conf /var/www/html/itop/env-production /var/www/html/itop/env-production-build
sudo chown :www-data /var/www/html/itop
sudo chmod g+w /var/www/html/itop

更改 iTop 設定檔以使其可寫入

sudo chmod 644 conf/production/config-itop.php

啟動安裝程式，在瀏覽器中使用 <your_itop_url>/setup。

選擇 Upgrade an existing iTop instance，點選 NEXT。

點選 NEXT

點選 NEXT

點選 NEXT

點選 NEXT

點選 NEXT

點選 NEXT

點選 NEXT

點選 INSTALL

點選 ENTER ITOP

為了完成安裝，需要進行以下手動操作。
Manual instructions for Tickets Management

恭喜您的 iTop 已經升級到 3.2 版本，多美好的一天。

最後來講一下升級路徑，例如您想要把 2.7 升級到 3.2 的版本，那麼您需要先將 2.7 升級到 3.0 的版本，再將 3.0 升級到 3.1，最後將 3.1 升級到 3.2。

記得閱讀升級路徑上的所有 Migrations Notes，不可以漏掉喔。

今天的介紹就到這邊了，希望有幫助到您。

參考文件

1. https://www.itophub.io/wiki/page?id=3_2_0%3Arelease%3Awhats_new
2. https://www.itophub.io/wiki/page?id=3_2_0%3Arelease%3Achange_log
3. https://www.itophub.io/wiki/page?id=latest%3Ainstall%3Aupgrading_itop
4. https://www.itophub.io/wiki/page?id=3_2_0%3Ainstall%3Amigration_notes